home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / fsdump.z / fsdump
Encoding:
Text File  |  1998-10-20  |  13.3 KB  |  265 lines
  1.  
  2.  
  3.  
  4. FFFFSSSSDDDDUUUUMMMMPPPP((((1111MMMM))))                                                          FFFFSSSSDDDDUUUUMMMMPPPP((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      fsdump - file system dumper for rfindd for EFS and XFS
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ccccdddd ////vvvvaaaarrrr////rrrrffffiiiinnnndddddddd;;;; ....////ffffssssdddduuuummmmpppp [----LLLL logfile] [----MMMM minutes] [----QQQQ] [----RRRR] [----UUUU maxrss]
  13.      ----FFFF dumpfile directory
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _f_s_d_u_m_p is applicable to EFS and XFS filesystems.
  17.  
  18.      _f_s_d_u_m_p creates the dddduuuummmmppppffffiiiilllleeee used by _r_f_i_n_d_d(1M) to respond to _r_f_i_n_d(1)
  19.      requests.  The dddduuuummmmppppffffiiiilllleeee contains:
  20.  
  21.      inode contents      For each allocated inode in the file system mounted
  22.                          at ddddiiiirrrreeeeccccttttoooorrrryyyy, _f_s_d_u_m_p stores all the fields from the
  23.                          inode header, excluding the extent and reference
  24.                          count fields.
  25.  
  26.      directory contents  For each directory in the file system that is
  27.                          readable by the user "rfindd", _f_s_d_u_m_p stores the
  28.                          inode numbers and filenames in that directory.
  29.  
  30.      Quick checksums     If the ----QQQQ option is specified, then _f_s_d_u_m_p stores a
  31.                          quick checksum of the data contents of each regular
  32.                          file in the file system.  This checksum only covers
  33.                          the first few bytes of each basic block (512 byte
  34.                          sector).
  35.  
  36.      RCS information     If the ----RRRR option is specified, then _f_s_d_u_m_p stores the
  37.                          top-of-trunk version number and date for each file in
  38.                          the file system that has a name of the form "RCS/*,v"
  39.                          and contains a parsable RCS header.  See _r_c_s_f_i_l_e(4)
  40.                          for a description of such files.
  41.  
  42.      The following options are accepted by _f_s_d_u_m_p.
  43.  
  44.      ----FFFF _d_u_m_p_f_i_l_e Tells fsdump where to write the data extracted during the
  45.                  run.
  46.  
  47.      ----LLLL _l_o_g_f_i_l_e  If specified, _f_s_d_u_m_p appends a few lines to the named
  48.                  llllooooggggffffiiiilllleeee, containing the date of the run and some statistics
  49.                  about the amount of space and time consumed.
  50.  
  51.      ----MMMM _m_i_n_u_t_e_s  If specified, limits the number of minutes since _f_s_d_u_m_p
  52.                  started that _f_s_d_u_m_p will spend extracting RCS information or
  53.                  checksums.  If either of the ----QQQQ or ----RRRR options is being used,
  54.                  and if _f_s_d_u_m_p is being run frequently, such as every hour,
  55.                  then use the ----MMMM option to tell _f_s_d_u_m_p how long it should run,
  56.                  before it writes out its partial results, and allows the next
  57.                  scheduled run to occur.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. FFFFSSSSDDDDUUUUMMMMPPPP((((1111MMMM))))                                                          FFFFSSSSDDDDUUUUMMMMPPPP((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      ----QQQQ          Requests _f_s_d_u_m_p to repeatedly compute a quick checksum on the
  75.                  contents of each file.  _f_s_d_u_m_p prints a warning message into
  76.                  the llllooooggggffffiiiilllleeee of the form:
  77.                       >>>>>> File contents corrupted !! :: <file>
  78.                  if the checksum changes for a file that was not modified via
  79.                  the file system.
  80.  
  81.      ----RRRR          Requests _f_s_d_u_m_p to maintain the RCS top-of-trunk revision and
  82.                  date for each apparent "RCS/*,v" file.
  83.  
  84.      ----UUUU _m_a_x_r_s_s   If specified, limits to mmmmaaaaxxxxrrrrssssssss kilobytes the amount of
  85.                  physical memory that this fsdump process can use.
  86.  
  87.      ddddiiiirrrreeeeccccttttoooorrrryyyy must be the directory on which is mounted the EFS or the XFS
  88.      file system to be dumped.
  89.  
  90.    CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn
  91.      To configure the _r_f_i_n_d services (_r_f_i_n_d_d and _f_s_d_u_m_p) on your system,
  92.      perform the following:
  93.  
  94.      1)   If you want _f_s_d_u_m_p to update all dddduuuummmmppppffffiiiilllleeee's on some schedule other
  95.           than starting at 3 minutes past each hour, then while ssssuuuu'd to
  96.           rfindd's uid, use the ccccrrrroooonnnnttttaaaabbbb(1) command to change the frequency of
  97.           execution of _r_u_n_f_s_d_u_m_p.  The following steps can be used to edit
  98.           rfindd's crontab file.
  99.  
  100.              a]   su root
  101.  
  102.              b]   su - rfindd
  103.  
  104.              c]   crontab -l > crontab
  105.  
  106.              d]   edit this crontab file
  107.  
  108.              e]   crontab crontab
  109.  
  110.      2)   To change the list of file systems to be dumped, edit the file
  111.           ////vvvvaaaarrrr////rrrrffffiiiinnnndddddddd////ffffsssslllliiiisssstttt.  By default, the basename of the mount point of
  112.           the file system is used as the dump file name.  If the file system
  113.           is "/", then the dump file name is taken as "root" instead.  To
  114.           specify a different dump file name, provide that name as the second
  115.           field on its line in ffffsssslllliiiisssstttt.  The logfile name is always the dump
  116.           file name with the suffix ".log" added.
  117.  
  118.      3)   To change the options with which _f_s_d_u_m_p is invoked, edit the file
  119.           ////vvvvaaaarrrr////rrrrffffiiiinnnndddddddd////ffffssssooooppppttttiiiioooonnnnssss.
  120.  
  121.      4)   Edit the file /etc/rfind.aliases on each client system that should
  122.           have access to the new rfind server.  If only the localhost needs
  123.           access, then this step is not needed.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. FFFFSSSSDDDDUUUUMMMMPPPP((((1111MMMM))))                                                          FFFFSSSSDDDDUUUUMMMMPPPP((((1111MMMM))))
  137.  
  138.  
  139.  
  140.    SSSSttttrrrraaaatttteeeeggggyyyy
  141.      _f_s_d_u_m_p typically performs the following steps each run:
  142.  
  143.      1)   parse arguments
  144.  
  145.      2)   map ddddiiiirrrreeeeccccttttoooorrrryyyy to file system device
  146.  
  147.      3)   open read-only file system device (requires setuid "root"
  148.           privileges)
  149.  
  150.      4)   open existing dddduuuummmmppppffffiiiilllleeee (if any)
  151.  
  152.      5)   relinquish "root" privileges
  153.  
  154.      6)   redirect stdout/stderr to llllooooggggffffiiiilllleeee (if specified)
  155.  
  156.      7)   determine file system parameters from super block for EFS
  157.           filesystems and XFS syssgi calls for XFS filesystems.
  158.  
  159.      8)   Lock the entire dddduuuummmmppppffffiiiilllleeee, to prevent simultaneous update attempts.
  160.  
  161.      9)   _m_m_a_p(2) existing dddduuuummmmppppffffiiiilllleeee into address space
  162.  
  163.      10)  read inodes from raw disk, one cylinder group at a time for EFS
  164.           filesystems and in numeric order for XFS filesystems.
  165.  
  166.      11)  test mtime, ctime, size and gen of each inode for changes
  167.  
  168.      12)  maintain current uid, gid, atime, nlink and mode for all inodes
  169.  
  170.      13)  discard directory, RCS and quick checksums information for any
  171.           changed inodes
  172.  
  173.      14)  close the file descriptor to the raw file system device
  174.  
  175.      15)  read any changed/new directories using opendir/readdir
  176.  
  177.      16)  rebuild secondary index on filenames
  178.  
  179.      17)  if -R specified and time permits, update RCS information for changed
  180.           "RCS/*,v" files
  181.  
  182.      18)  if -Q specified and time permits, update quick checksums for all
  183.           regular files
  184.  
  185.      19)  write new dddduuuummmmppppffffiiiilllleeee to temporary name
  186.  
  187.      20)  touch the start time of the new dddduuuummmmppppffffiiiilllleeee to the beginning time of
  188.           this run
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. FFFFSSSSDDDDUUUUMMMMPPPP((((1111MMMM))))                                                          FFFFSSSSDDDDUUUUMMMMPPPP((((1111MMMM))))
  203.  
  204.  
  205.  
  206.      21)  update the fsdump.{pag,dir} files
  207.  
  208.      22)  _r_e_n_a_m_e(2) temporary name to specified dddduuuummmmppppffffiiiilllleeee name
  209.  
  210. FFFFIIIILLLLEEEESSSS
  211.      /etc/config/rfindd          _c_h_k_c_o_n_f_i_g(1M) file controlling _f_s_d_u_m_p and
  212.                                  _r_f_i_n_d_d(1M).
  213.      /var/rfindd/fsdump.dir,
  214.      /var/rfindd/fsdump.pag      contain database (in _n_d_b_m(3B) format) of each
  215.                                  ddddiiiirrrreeeeccccttttoooorrrryyyy and dddduuuummmmppppffffiiiilllleeee in ////vvvvaaaarrrr////rrrrffffiiiinnnndddddddd.
  216.                                  _f_s_d_u_m_p updates this database each run, and
  217.                                  _r_f_i_n_d_d uses the database to map the requested
  218.                                  ddddiiiirrrreeeeccccttttoooorrrryyyy to the dddduuuummmmppppffffiiiilllleeee containing
  219.                                  information about it.
  220.      /var/rfindd/dddduuuummmmppppffffiiiilllleeee        The file system information extracted by
  221.                                  _f_s_d_u_m_p is stored here for use by _r_f_i_n_d_d(1M).
  222.                                  The first 12 lines of this file contain an
  223.                                  ASCII header describing the remaining,
  224.                                  binary, sections of the file.  The dddduuuummmmppppffffiiiilllleeee
  225.                                  typically requires between 1% and 2% of the
  226.                                  inuse space of the file system being dumped.
  227.      /var/rfindd/dddduuuummmmppppffffiiiilllleeee.log    Conventional name for the llllooooggggffffiiiilllleeee, as
  228.                                  specified in the ccccrrrroooonnnnttttaaaabbbb invocation of
  229.                                  _f_s_d_u_m_p.
  230.      /etc/init.d/rfindd          The runtime startup script, invoked by
  231.                                  _i_n_i_t(1M), that starts the _r_f_i_n_d_d(1M) daemon
  232.                                  process.
  233.      /usr/spool/cron/crontabs/rfindd
  234.                                  The ccccrrrroooonnnnttttaaaabbbb file that invokes _f_s_d_u_m_p.
  235.      /var/rfindd/rotatelogs      Utility invoked from the ccccrrrroooonnnnttttaaaabbbb for
  236.                                  "rfindd".  Each llllooooggggffffiiiilllleeee named on the command
  237.                                  line of _r_o_t_a_t_e_l_o_g_s is moved to the file
  238.                                  OOOOLLLLDDDDllllooooggggffffiiiilllleeee.
  239.      /var/rfindd/fslist          The list of file systems to be examined by
  240.                                  _f_s_d_u_m_p(1M).  The _r_u_n_f_s_d_u_m_p script uses this
  241.                                  list.
  242.      /var/rfindd/fsoptions       The list of options to be passed when
  243.                                  invoking the _f_s_d_u_m_p(1M) command.  The
  244.                                  _r_u_n_f_s_d_u_m_p script uses this list.
  245.      /var/rfindd/runfsdump       The script, executed from _c_r_o_n once each
  246.                                  hour, or as otherwise specified, which
  247.                                  invokes _f_s_d_u_m_p on each file system listed in
  248.                                  _f_s_l_i_s_t, using the options specified in
  249.                                  _f_s_o_p_t_i_o_n_s.
  250.      /var/rfindd/passwd.add      Utility used by _i_n_s_t exitop to add the user
  251.                                  "rfindd" to the file ////eeeettttcccc////ppppaaaasssssssswwwwdddd.
  252. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  253.      chkconfig(1M), crontab(1), rfind(1), rfindd(1M).
  254.      mmap(2), rename(2), ndbm(3B), fs(4), rcsfile(4).
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.